home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / scrnsvrs / boinksav.lzh / READTHIS.1ST < prev   
Text File  |  1992-01-21  |  7KB  |  121 lines
  1. What should have been in the LZH file:
  2.  
  3.     BOINK.PRG      The program.
  4.     BOINKCFG.PRG   The config program.
  5.     READTHIS.1ST   This file.
  6.     IMAGES\        A folder containing several .BSI files.
  7.  
  8. This program is Freeware.  You may distribute it as you see fit, but you can't
  9. charge for it, except reasonable charges to cover the cost of the media it's
  10. distributed on (read: PD/Shareware collections are okay).
  11.  
  12. What this is:
  13.  
  14. In the tradition of creating screen savers that are anything but tame (one of
  15. R. Glover's common complaints about screen savers), this is BoinkSave.  Put
  16. BOINK.PRG in your AUTO folder and if you don't press a key or move the mouse
  17. for two minutes, the screen will display a bouncing, spinning ball (reminiscent
  18. of the old, old Boink demo) until you do.  This program consumes a whopping 43K
  19. of RAM, even though it's only 10K; that's the price you pay for interesting
  20. screen savers.  Fortunately it only consumes 12% of processor time when
  21. actually bouncing the ball.  It should run on a TT, but I can't say for certain
  22. (I don't have a TT to test it on, do I?)  BoinkSave will NOT run in monochrome;
  23. if you try, it won't install itself.  That way you don't have to worry about
  24. turning it off when you switch monitors.
  25.  
  26. The BOINKCFG program will take some explaining.  Not that it's hard to use,
  27. just that there's a bit to it.  When you run it, from any resolution, you'll
  28. see a small alert box with three buttons on it: "Config", "Disable", and
  29. "Exit".  "Config" will bring up the configuration dialog.  "Disable" will
  30. disable BoinkSave completely; you'll notice the button changes to "Enable!",
  31. which will re-enable BoinkSave.  And "Exit" will turn on the screen saver and
  32. exit the program.  (The screen saver will shut off when you move the mouse or
  33. press a key, of course.)
  34.  
  35. In the "Config" dialog you will also find three buttons: "Time", "Boink", and
  36. "Exit".  Clicking on "Time" will allow you to set the time BoinkSave will wait
  37. before kicking in.  Use the "<" and ">" buttons to change the time displayed;
  38. click on the time itself when you're satisfied.  "Boink" will bring up yet
  39. another dialog, allowing you to adjust aspects of the animation in BoinkSave.
  40. Here you can choose "Speed", "Graphic", or "Exit".  "Speed" will allow you to
  41. choose "Fast", "Medium", or "Slow".  On an unmodified ST, these consume 23%,
  42. 12%, and 8% of processor time, respectively.  Once one of these buttons is
  43. selected, BoinkSave will activate, showing you what the speed looks like.  Move
  44. the mouse or press a key to return to the dialog.  "Graphic" will allow you to
  45. load a .BSI file (contained in the IMAGES folder) for a different graphic; once
  46. loaded, BoinkSave will activate, so you can see the new graphic.  Move the
  47. mouse or press a key to return to the dialog.  "Exit", as with the other "Exit"
  48. buttons in the program, exits back to the previous dialog.  If you exit from
  49. the "Config" dialog, you will be asked if you want to save the configuration;
  50. click on "Okay" to save to \AUTO\BOINK.PRG, "Locate" to find a different copy
  51. of the program, or "Cancel" to abort the save.
  52.  
  53. Phew!  That's just about everything you *need* to know to use BoinkSave.  There
  54. are, however, a few more things I'd like to point out.  Recently I released a
  55. screen saver called "Faze".  The config program from it can be used to
  56. configure BoinkSave, although you'll only be able to change the "Time" and
  57. "Look" at the saver; you won't be able to save the configuration.  The config
  58. program for BoinkSave can be used on Faze, and you *can* save the configuration
  59. to FAZE.PRG.  The extras, naturally, won't be saved; just the time delay.
  60.  
  61. One more thing.  The "Disable" function only works if BoinkSave (or Faze) was
  62. the last program to install itself on the vertical blank interrupt.  You can
  63. make sure this is so by placing BOINK.PRG or FAZE.PRG _last_ in your AUTO
  64. folder.
  65.  
  66. Well, I didn't expect to write this much about BoinkSave, but I did.  If you
  67. have comments/questions/complaints/suggestions, you can write to:
  68.  
  69.     Damien M. Jones
  70.     PSC 8 Box 657
  71.     APO AE 09109
  72.  
  73. I wrote this program because I couldn't get the idea out of my head; I thought
  74. perhaps if I got it over and done with, I might be able to get back to my
  75. current project.  Oh well.  Until the next program...
  76.  
  77.     -dmj
  78.  
  79.  
  80. File format of .BSI files:
  81.  
  82. Obviously, there are some of you out there who are itching to put together your
  83. own animations for this program.  Fine, no problem.  Here's the format of the
  84. .BSI files used by BOINKCFG.PRG:
  85.  
  86. [8 bytes]     ID bytes, read "dmj³.BSI".
  87. [2 bytes]     Number of X positions to use.
  88. [2 bytes]     Number of Y positions to use.
  89. [640 bytes]   X positions; these are values ranging from 0-288, as a list of
  90.               words.  Note that even though they must all be here, they are
  91.               not always used, depending on the value listed above.
  92. [400 bytes]   Y positions; these are values ranging from 0-168, as a list of
  93.               words.  Note that even though they must all be here, they are
  94.               not always used, depending on the value listed above.
  95. [32 bytes]    Palette, in standard 16*RGB format.  May be STe if you like.
  96. [8192 bytes]  The images.  These are sixteen 32x32 rasters in four bitplanes.
  97.               If you're using GFA BASIC, you can use GET; just remember to
  98.               clip off the first six characters of the GET string, since GFA
  99.               BASIC uses that part to record the size of the image.
  100.  
  101. That's really all there is to it.  Not very complicated, but adequate for the
  102. situation.  If you get any really good .BSI's, I'd be interested in seeing
  103. them... send them to the above address.
  104.  
  105. -------------------------------------------------------------------------------
  106. Warning: what follows is a completely blatant advertisment.  Read at own risk.
  107. -------------------------------------------------------------------------------
  108. Say, have you heard about DMJ GIF?  It's one of the most popular GIF converters
  109. for the ST, and with good reason!  DMJ GIF takes high quality GIF images and
  110. converts them to high quality Spectrum images.  Or DEGAS or Tiny pictures.  In
  111. full color, or grey scale, or monochrome.  With the ST's 512-color palette or
  112. the STe's 4096-color palette.  It also includes programs to convert Spectrum
  113. pictures to low or high resolution DEGAS pictures.  And it even includes a
  114. program to view STe Spectrum pictures on an ST, in 3375 colors!  There's even
  115. more, but I don't have space to list everything here.  So where can you get
  116. this marvel?  Try GEnie.  Or CompuServe.  Or your local BBS.  (You're looking
  117. for DMJ_GIF3.LZH.)  Can't find it on your local BBS?  I've got plenty of copies
  118. (grin).  Registered versions (which run twice as fast as distributed versions!)
  119. are available at the above address for only $15, and that includes a printed
  120. manual.  So what are *you* waiting for?
  121.